SLA e Tempos de Processamento Pix
PIX_PROCESSINGO status PIX_PROCESSING indica que a sua requisição foi recebida com sucesso e a ordem de pagamento já está em andamento no sistema. Esse é um comportamento padrão e esperado dentro da janela operacional do Pix, e não significa que a transação falhou.
Para garantir transparência e melhorar a experiência de integração, esta página detalha o que esperar durante o processamento de pagamentos e transferências Pix (Cash-out). A maioria das transações acontece em uma fração de segundo; no entanto, pequenas variações de tempo são normais e previstas pelas regras do Banco Central.
Entendendo o PIX_PROCESSING
Quando você envia uma instrução de Cash-out via Pix, ela passa por uma série de validações e transita entre a instituição de origem, os sistemas do Banco Central e a instituição de destino. Durante esse trajeto, a transação assume o estado transitório PIX_PROCESSING.
Isso quer dizer que os sistemas estão se comunicando para efetivar a liquidação do pagamento. É o ciclo natural de vida da transação.
Tempos Esperados de Processamento
Os intervalos de tempo abaixo têm como base o Manual de Tempos do Pix estabelecido pelo Banco Central do Brasil.
| Tipo de transação | Tempo esperado | Como interpretar o status | Ação recomendada |
|---|---|---|---|
| Pix Imediato | Até 40 segundos | A transação está em trânsito regular entre as instituições de origem e destino. | Aguarde. O comum é que a confirmação final aconteça em bem menos tempo. |
| Pix Agendado | Até 45 minutos | A instrução entrou na etapa de processamento do arranjo Pix na data agendada. | Aguarde a conclusão da transação dentro desta janela operacional. |
Importante: Os tempos descritos acima são contados a partir do momento em que a instrução entra na etapa de processamento do arranjo Pix (envio da ordem para processamento).
Quando aguardar?
Sempre que a sua transação retornar um status PIX_PROCESSING recente (dentro da janela de tempo informada acima), a ação recomendada é simplesmente aguardar.
Durante a troca de mensagens entre as diferentes instituições participantes do arranjo Pix, alguns segundos adicionais podem ser necessários para a validação e liquidação da transação. Nenhuma intervenção manual ou reenvio da transação é necessário dentro do tempo limite esperado.
Quando consultar novamente ou acionar suporte?
Acompanhe o status da transação de forma ativa, mas respeitando os limites:
- Para Pix Imediato: Se o status
PIX_PROCESSINGpersistir por mais de 40 segundos, você pode consultar novamente o status através do endpoint de consulta da transação. - Para Pix Agendado: Se o status não evoluir para concluído ou com falha após 45 minutos do início do processamento no dia da efetivação, consulte o status novamente.
Se após novas consultas o status de liquidação permanecer inalterado muito além do SLA esperado, você pode acionar nosso time de suporte informando o endToEndId ou o ID da transação (conforme documentado na consulta de pagamento), para que possamos avaliar se houve alguma instabilidade sistêmica no arranjo.
Lembre-se: o PIX_PROCESSING é um status transitório. Sempre valide o desfecho final da operação em tempo real via Webhooks ou consultando ativamente o endpoint de status. Considere a transação finalizada apenas quando receber os status finais correspondentes (ex: PIX_EFFECTIVE ou PIX_ERROR).